package cn.iocoder.yudao.module.book.service.records;

import java.util.*;
import javax.validation.*;
import cn.iocoder.yudao.module.book.controller.admin.records.vo.*;
import cn.iocoder.yudao.module.book.controller.app.records.vo.AppRecordsRespVO;
import cn.iocoder.yudao.module.book.dal.dataobject.records.RecordsDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

/**
 * 阅读记录 Service 接口
 *
 * @author xi
 */
public interface RecordsService {

    /**
     * 创建阅读记录
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Integer createRecords(@Valid RecordsSaveReqVO createReqVO);

    /**
     * 更新阅读记录
     *
     * @param updateReqVO 更新信息
     */
    void updateRecords(@Valid RecordsSaveReqVO updateReqVO);

    /**
     * 删除阅读记录
     *
     * @param id 编号
     */
    void deleteRecords(Integer id);

    /**
     * 获得阅读记录
     *
     * @param id 编号
     * @return 阅读记录
     */
    RecordsDO getRecords(Integer id);

    /**
     * 获得阅读记录分页
     *
     * @param pageReqVO 分页查询
     * @return 阅读记录分页
     */
    PageResult<RecordsDO> getRecordsPage(RecordsPageReqVO pageReqVO);

    Boolean deleteByBookId(@Valid Integer id);

    Boolean deleteByCollectionId(@Valid Integer id);

    List<RecordsDO> selectDayRecord(Long userId, String time);

    List<AppRecordsRespVO> getReadSummary(Long currentUserId);

    Boolean deleteByUserId(Long currentUserId);

    List<AppRecordsRespVO> getRecentWeekRecords(Long currentUserId);

    /**
     * 根据用户ID和绘本ID获取阅读记录
     *
     * @param userId 用户ID
     * @param bookId 绘本ID
     * @return 阅读记录
     */
    RecordsDO getByUserIdAndBookId(Long userId, Integer bookId);

}